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Introduction 
Domoticz isa Home Automation system design to control various devices and receive input from various sensors. 


For example this system can be used with: 


- Light switches 

- Door sensors 

- Doorbells 

- Security devices 

- Weather sensors like: UV/Rain/Wind Meters 
- Temperature Sensors 

- Pulse Meters 

- Voltage / AD Meters 

- And more... 


System Requirements 
This system is designed to run on most common hardware, this includes: 


- Raspberry Pi (Model B/2 advised) 
- Cubieboard/Cubietruck 

- Unix 

- Apple 

- Windows 


256MB memory recommended, 200MB free hard disk space, Firefox/Chrome/Safari browser. A screen 
resolution SXGA = 1280x1024 or higher is recommended. 


If you want to use Internet Explorer, you need version 10+. 


Most information can be found on the Domoticz wiki (http://www.domoticz.com/wiki) 


Hardware 
There are various hardware components that the system can use. Some are specifically made for the Raspberry Pi. 


RF 433Mhz - RFXCOM RFXtrx433, http://www .rfxcom.com t 

RF Z-Wave - Razberry Z-Way http://razberry.z-wave.me * 

RF Z-Wave — OpenZWave, Aeon ZStick http://aeotec.com/z-wave-usb-stick * 

P1 Smart Meter (serial) ? 

YouLess Energy Meter http://www.youless.nl 

TE923 Weather Station (Hideki weather station like IROX Pro X, Mebus TE923 or TFA Nexus) 
http://www.tdressler.net/ipsymcon/te923.html 3 

Davis Vantage Weather Station (with USB connector) 

Eco Devices http://gce-electronics.com/en/nos-produits/409-module-teleinfo-eco-devices.html 
Rego 6XX (serial) http://rago600.sourceforge.net 

Voltcraft CO-20 Air Quality meter http://www.conrad.com/ce/en/product/101316/Voltcraft-CO20-USB-Air- 
Quality-Sensor 

1-Wire (OWFS, or direct on the Raspberry Pi) 

Philips Hue 

AppLamp/Limitless 

Forecast.io 

Weather Underground 

GPIO 

ICY Thermostat (Essent) 

Logitech Harmoney Hub 

Meteostick 

Mochad 

Opentherm Gateway 





Teleinfo 
Toon Thermostat 
BMP085 |I2C Temp+Baro sensor http://learn.adafruit.com/using-the-bmp085-with-raspberrypi/overview 





Weather Underground (If you do not want to own your own weather station) 
http://www .wunderground.com 

PiFace Raspberry Pi lO Expansion board https://www.sparkfun.com/products/11772 
SO Pulse Meter ? 

EnOcean (At the moment only with Protocol version2, FAM-USB stick) 

SolarEdge single phase inverters with TCP (aka SE5000) 

SBFSport (SMASpot) (SMA inverter over bluetooth or Speedwire) 


Meteostick (http://www .smartbedded.com/meteostick) (Davis® weathers station readout) 


1 Consult the hardware manufactures website for supported devices. 
2 Prefabbed cables available at http://www.smartmeterdashboard.nl/webshop 
3 Only supported under Unix at the moment 
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Installation 
Please consult the wiki pages for details. http://www.domoticz.com/wiki/Main Page 


Raspberry Pi 


The easiest way to get started is to download the SD Card image from sourceforge. 


http://sourceforge.net/projects/domoticz/files 


Unix/Linux/Raspberry Pi/.... 
See the Install.txt file for installation/compile instructions. 


Windows Users 
An installer is provided for easy installation. 


http://sourceforge.net/projects/domoticz/files 
When updating the software, do not uninstall, just reinstall, or the central database is deleted! 


When the application is started under Windows, a system tray popup message will display the port used to connect 
to: 





Domoticz Home Automation * X 


Application Started. 
Webserver port: 8080 





Usage 


The core application runs at the background, and has a web-based user interface. 
The default port of the web interface is 8080. For a local setup you can connect to http://127.0.0.1:8080 


To access the system from a remote location, consult your router manual to forwarding/NAT a port to your system. 


Navigation 





Domoticz..... É Dashboard | ? Lights/Switches À Temperature | * Weather | Utility | * Devices | * Setup ~ 
Navigation is done by pressing the tabs at the top of the webpage. 


Most tabs are automatically refreshed every 10 seconds. (Except Devices/Hardware/Setup) 


Command Line parameters 
The following command line parameters are available: 


-www port (for example -www 8080) 

-sslwww port (secure web port, for example -sslwww 443) 

-dbase file path (for example D:\domoticz.db or /opt/domoticz/domoticz.db) 
-verbose x (where x=0 is none, x=1 is debug) 

-startupdelay seconds (default=0) 

-nowwwpwd (in case you forgot the webserver username/password) 
-nobrowser (do not start web browser) (Windows Only) 

-log file path (for example D:\domoticz.log) 

-loglevel (O=All, 1=Status+Error, 2=Error) 

-nocache (do not cache HTML pages (for editing) 

-daemon (run as background daemon) (Unix Only) 

-syslog (use syslog as log output) (Unix Only) 


If Domoticz is compiled with SSL support: 


-sslwww port (for example -sslwww 443) 
-ssicert file_path (for example D:\server_cert.pem or /opt/domoticz/server_cert.pem) 


If no —sslcert parameter is provided, Domoticz will use server_cert.pem from its installation folder 


Unix Starup Script 


To start Domoticz automatically when the system starts perform the following steps: 


sudo cp domoticz.sh /etc/init.d sudo chmod +x 
/etc/init.d/domoticz.sh 
sudo update-rc.d domoticz.sh defaults 


Edit the startup script and change the USERNAME, DAEMON and DAEMON ARGS parameters to reflect your current 
settings 


sudo vi /etc/init.d/domoticz.sh 
USERNAME=pi 


DAEMON=/home/SUSERNAME/domoticz/SNAME 
DAEMON ARGS="-daemon -www 8080 —sslwww 443" 


If you want to use another web interface port change: 
DAEMON ARGS="-daemon -www 8080 —sslwww 443" 


Test Domoticz 
./domoticz 


Start Domoticz 
sudo service domoticz.sh start 


Stop Domoticz 
sudo service domoticz.sh stop 


Check if Domoticz is running 
sudo service domoticz.sh status 


Hardware Setup 


Before you can use the application to control devices you must setup the communication hardware device(s). 


Hardware 


A Application Settings 


= Log 





Setting up a USB device 


First make sure the device is recognized in the system. 


Domoticz automatically detects the USB port. 


Name Home 


Type: RFXCOM - RFXtrx433 USB 433.92MHz Transceiver 


Serial Port: COM4 x| 


Shared: M 





Setting up a LAN device 


First make sure you know the IP address and port of the device. 
Name: Home 


Type: RFXCOM - RFXLAN Transceiver 433.92 MHz with LAN interface |x| 


Remote Address: 192.168.0.148 


port: 11011 


Shared a 
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Sharing Devices 
It is possible to share your (Domoticz) sensors with your friends. For instance you can share your Rain Meter, but also 
lights/switches that other people can control. 


For this, you need to enter an Administrator username/password in the application settings. Then you can add users 
and assign sensors/switches to this user. 


Consult the documentation of the router on how to setup a Firewall/NAT/Forward rule. 


Domoticz Remote Server 
To receive sensors from other people, you have to add a ‘Domoticz — Remote Server’ hardware device, specify the IP 
Address/Port of the remote Domoticz server, and username and password. 

Enabled: 


Name: RemoteDomoticz 


Type: Domoticz - Remote Server 


Remote Address: 188.199.200.201 
Port: 6641 


Username: username 


Password: TILLITI) 





By pressing the ADD button, the hardware is added to the system and will automatically start. 


You can see a debug console (windows) by pressing the right mouse button on the Domoticz icon in the system tray. 
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Application Settings 


There are various application settings. For control of Light/Switches based on Sun Set /Sunrise timings, it is important 
to setup your location. 


x Devices 


Hardware 


AN Application Settings 





Location Setup 
To setup your location click on the ‘Setup’ tab, and enter the Latitude/Longitude parameters. 


Location: 


Latitude 


Longitude: 
To find your location click 





If you do not know these parameters, press the “Here” link and enter your address: 
Find your Geo location 


Address: |My Street 
(Example: Streetname Number City Country) 


GetLatLong 


Latitude: 31.329620 


Longitude: |-85.843533 





When pressing OK the parameters are accepted by the application. 


Press the SAVE button to store the settings. 


12 


Notification Setup 
Notifications can be send for example when a switch is pushed, electricity usage is too high, temperature to high and 
for many more options. 


The following systems are supported: Prowl and NMA 


Prowl (iPhone/iPad notification system): NMA (Android notification system): 


API Key: 1234567890123456 7890abcdefl234567890abc API Key 12345678901234567890abcdefl234567890abc 
To get a free account/API key click To get a free account/API key click 


Light/Switch History 
With this parameter you can specify the amount of Log days that a Light/Switch will hold. 


Light/Switch History: 





Days 30 





Short Log History 


Every meter/sensor data will be logged each 5 minutes. By default 1 day of 5 minute logs will be kept. 


It is possible to enlarge this window to 7 days, but keep in mind this will cost more hard disk space, and when working 
remotely there is more data to transfer resulting in a slower response. 


Short Log History: 


DEVE | y | 





Dashboard Mode 


The default page (dashboard) supports several layout modes: 


- Normal 
- Compact 
- Floorplan 
- Mobile* 


, 


*On mobile devices (iPhone/iPad/Android/...) the layout is always Mobile 
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Website Protection 
By default no username/password is needed to access Domoticz via the web browser. 


If you wish to protect Domoticz (for instance if you have shared the port to the outside world), you can specify the 
Username/Password that needs to be entered to access the system. 


Website Protection: 


Username: secret 


Password TT TT 
Local Networks (no username/password) 


Networks 127.0.0.1:192.168.0.* 
(Separate by a semicolon, For Example: 127.0.0.*:192.168.0.*) 





It is also possible to specify the ‘Local Networks’ that does not have to enter a Username/Password. 


Resetting the Website Username/Password 
To reset the website username/password incase this is lost... there are two options. 


- Specify -nowwwpwd as command line argument 


- Place a file labeled ‘resetpwd’ inside the root Domoticz installation folder. 
Each minute the existence of this file is checked, and if found the Username/Password is reset and the file is 
removed. 


Security Panel 
The system has a security panel to specify if you are home/home-armed/away 


Security Panel: 


Password: e... 





You can use this as an alarm system 


Remote Sharing 
If you wish to share your sensors to other users, you can specify the remote port that Domoticz will listen on for 
remote connections. Consult your router for setting up a firewall/nat rule to this port. 


Remote Shared Port (For Remote Domoticz clients): 


Port: (6144 
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The Domoticz system can be updated (Raspberry Pi) via the web interface. 


There are two options: 


- Stable versions (recommended) 
- Beta versions (developer versions) 


Software Updates: 


Check for Updates (Not working on windows systems) 


Release Channel Stable x| 





With this setting you can hide certain tabs you do not wish to see. For example if you do not own utility devices you 
can hide this tab. 


Active Menus: 
@ Floorplan 
Switches 
Scenes 
Temperature 
Weather 
Utility 





If you enter your email details here, you can receive notifications/web cam screenshots and more. 


Email Setup 


(Separate by a semicolon, For Example: user@mail.com;user2@mail.com) 


Server: 


Port: | |25 (default 25, StartTLS Port 587, SSL Port 465) 


Username: 


Send Email Notification Alerts 
W Send Camera snapshots as Attachment (Gmail) 
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Meter/Counter Setup 


Wind Meter 
Wind meter notation (m/s, km/h, mph or knots) 


Wind Meter: 


Display 





OWL 113 display mode 
By default the OWL 113 is displaying the Current in Amperes. It is possible to display this in Energy (Watt). For this you 
need to supply the normal housing voltage. 


OWL CM113: 


Voltage: 226 
Display: Watt 





RFX/Meter Dividers 
Some utility devices might use another basic scale for their meter (turns/minute for example). 


RFXMeter/Counter Dividers: 
Energy 1000 Costs T1 0.2149 / kWh Costs T2 0.2149 / kWh 
Costs: 0.6218 / m3 


Costs 1.6473 / m3 





<< These are the default settings. 


It is also possible to enter the costs for Energy, Gas and Water here. These values will be used when displaying 
reports. 


Other Settings 
Other Settings 


Random Timer: 
Spread: |15 (Minutes +/-) 


Doorbell Command: 


Command: Group On x| 


Raspberry Pi Camera Parameters: 


-w 800 -h 600 -t0 
(default: -w 800 -h 600 + 0) 


Params: 
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Devices 
Once the application is running it will collect all devices found/received and begin logging the messages. 
— cd - Wind TEA 0, 202 00,SSW.13:25:8.7:8.3 12: 


ving Meter 





Temp + Humidity Cresta, TFA 23.5 C, 34 % 
TSHC 


Temp. Outside Temp + Humidity Cresta, TFA 4.00. 94% 
TS34C 

Rain Meter Rain TFA 0, 0:672.7 

AC On, Level: 100 % 


0.1 UVI, 7.0°C 


i Temp. Livingroom 


x 


32780 

0674EE6 LightSwitch Hobby Room Lighting 2 a pa 
36624 UV Meter uv 

69 not used Lighting 1 
073E33A Dusk Detector Lighting 2 
04DDB3E Outside Light Lighting 2 
79 not used Lighting 1 
79 not used Lighting 1 
79 not used Lighting 1 
79 Sunset Switch Lighting 1 
0490532 Doorbell Side Lighting 2 
O7FOFF not used Lighting 5 


O7FFFF not used 


2012-12-01 11 
2012-12-01 11 


Devices can be Added/Removed from this tab. Light devices can also be added to the system from the 


‘Lights/Switches’ tab. 
To Add temperature/weather sensors press the add button, and enter a name. You will now find them in their 


respective tabs. 
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Temperature 
The temperature tab includes all sensors that have a temperature sensor. 





{ Outside 10.1° / 75%) MN (Wind 10º / 10°) MN (uv 
Status: 10.1º C, Humidity: 75 % (Wet) Status: 10º C, Chill: 10° C Status: 9.7º C 
Dew Point: 5.87° C 337 NNW, Speed: 0.0 m/s, Gust: 0.0 m/s Last Seen: 2013-10-10 19:20:06 
Last Seen: 2013-10-10 19:34:22 Last Seen: 2013-10-10 19:22:48 


Y Edit | Notifications wW Notifications Y Notifications 


[ Pond 14.4" | 92%) MW | Living 20.2º 1 70%) Y | Loft 21.5° 147%) 
Status: 14.4° C, Humidity: 92 % (Wet) Status: 20.2° C, Humidity: 70 % (Wet) O Status: 21.5” C, Humidity: 47 % (Comfortable) 











Dew Point: 13.12° C Dew Point: 14.55° C Barometer: 1008 hPa, Prediction: Partly Cloudy 
Last Seen: 2013-10-10 19:25:16 = Last Seen: 2013-10-10 19:25:41 Dew Point: 9.71° C 


Last Seen: 2013-10-10 19:34:15 


Y Edit | Notifications w Edit | Notifications wW Notifications 





{ Fridge 7.1° 141%) im ( Bathroom 21° | 52%) IN [ Garage 15.6° / 81%) 


Status: 74º C, Humidity: 41 % (Comfortable) Status: 21” C, Humidity: 52 % (Comfortable) Status: 15.6” C, Humidity: 81 % (Wet) 
Dew Point: -5.28º C Dew Point: 10.77° C Y? Dew Point: 12.35º C 
Last Seen: 2013-10-10 19:19:21 = Last Seen: 2013-10-10 19:34:17 = Last Seen: 2013-10-10 19:31:35 


Y Notifications is Log É Edit | Notifications 








A temperature sensor can also include a Humidity sensor. 


Each item has the following options: 


- Favorite push icon (to display this device on the Dashboard tab) 
- Log (Displays the log) 

- Edit (Edit device parameters) 

- Notifications (see Notification chapter) 


By Dragging/Dropping the sensor items, you can change the position of the devices in the window. 
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Log 


By pressing the log button you can see the log of the sensor. It is possible to zoom in/out. 


Temperature Last 24 hours 


degrees Celsius 


2012-12-14 13:20 


Temperature Last Month 


Temperature Last Year 





By pressing the BACK button you return to the overview. 
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Edit 
Edit Device 


Name: UV Meter 


Adjustment. (0 “HE 


Update 





In this dialog you can rename the device, remove, or replace it. 


Replace 
Some devices change their unique ID when a new battery is installed. 


To replace the old sensor data to the new device act as follow: 
First, add the new device to the system, and call it for example “New UV Meter”. 
Next press the Edit button on the Old device, select replace and select the new Device. (In this case the devices called 


‘New UV Meter’. 


Replace Device 


Nieuw apparaat: 
New UV Meter 





Next press OK. 


Now you can rename the new device back to ‘UV Meter’. 


20 


Notifications 
Name: Temp. Buiten 


Show entries 


Type ~ When 
Temperature Greater then 20 ° C 
Temperature Below -2 ° C 


Showing 1 to 2 of 2 entries 


Update Delete 


Type 
When: 


Value: 





Each device has different notifications (depending on the hardware options). 
For example, in the above screenshot, you want to be notified if the temperature drops below -2 degrees. 


See the Notification chapter for more details. 
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Weather 


The weather tab includes all sensors that are related to weather... 





{ Wind Meter 


[ Rain Meter 


[ UV Meter 





Temp: 9.7º C, Chill: 9.6º C 
Last Seen: 2012-12-15 13:03:58 


ia Status: 180 S, Speed: 1.2 ms, Gust: 3.4 ms 
— Type: Wind, TFA 


“ OOED 


Status: 0.0 mm, Rate: 0 mm/h 
“> Last Seen: 2012-12-15 13:01:43 
*4444? Type: Rain, TFA 


É Notifications 


Status: 0.1 UVI, Temp: 9.8° C 
Last Seen: 2012-12-15 13:01:35 
> Type: UV, TFA 


t OOED 





[ TempHumBaro Hobby Kamer 


[ Shared Wind 





{ Shared UV Meter 





= Status: 996 hPa, Prediction: Sunny 
P Last Seen: 2012-12-15 13:03:42 
Type: Temp + Humidity + Barometric, THB2 - BTHR918N, 
f  BTHR968 


Temp: 6.2º C, Chill: 6.2º C 
Last Seen: 2012-12-11 14:49:43 


pe Status: 67 ENE, Speed: 1.0 ms, Gust: 1.1 ms 
Type: Wind, TFA 





Status: 0.0 UVI, Temp: 3.6° C 
Last Seen: 2012-12-11 14:31:52 
É, Type: UV, TFA 


t BUU “ DOCE 





A weather sensor can be: 


- Rain Meter 
- Wind Meter 
- UV Meter 

- Barometer 


Each item has the following options: 


- Favorite push icon (to display this device on the Dashboard tab) 
- Log (Displays the log) 

- Edit (Edit device parameters) 

- Notifications (see Notification chapter) 


By Dragging/Dropping the sensor items, you can change the position of the devices in the window. 
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Rain 


Rainfall Last week 


Month 


Rainfall Last Month 


Rainfall Last Year 
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Utility 
The utility tab includes Meter Sensors (Energy / Gas / P1 / YouLess / Voltage / AD / Air Quality / ...) 








[ P1 Smart Meter Electra { P1 Smart Meter Gas { OWL1 
E Status: 842.622, Today: 5.745 kWh, Usage: 740 Watt Status: 899.691, Today: 8.831 m3 Y Status: 32 Watt, 4195798.98 Wh 
EN 








Last Seen: 2013-02-16 13:27. Last Seen: 2013-02-16 13:25:24 Last Seen: 2012-12-17 19:37:27.000 
Type: P1 Smart Meter, Energy Type: P1 Smart Meter, Gas Type: Energy, CM119 / CH160 


dr t ET ú 








{ OWL2 [ RFXMeter Electra [ RFXMeter Water 








Last Seen: 2012-12-26 09:50:00 
Type: RFXMeter, RFXMeter counter 


Status: 0 Watt, 1378 Watt, 0 Watt Status: 9071024, Today: Status: 835857, Today: 
Last Seen: 2013-01-22 10:48:14 Last Seen: 2012-12-26 09:50. EN 


50:00 
Type: Current, CM113, Electrisave Type: RFXMeter, RFXMeter counter 





{| YouMeter Electro 
E Status: 39551.668, Today: , Usage: 575 Watt 





Last Seen: 2013-01-15 18:35:30 
Type: YouLess Meter, YouLess counter 


Er Notifications 





Each item has the following options: 


- Favorite push icon (to display this device on the Dashboard tab) 
- Log (Displays the log) 

- Edit (Edit device parameters) 

- Notifications (see Notification chapter) 


By Dragging/Dropping the sensor items, you can change the position of the devices in the window. 


Labels 


When using the dashboard in compact or mobile mode, there is limited room for the current status. 


Therefor the following labels apply: 


R = Return 
T = Today 
U = Usage 
A = Actual 
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Lights/Switches 


The lights/switches tab includes devices like: 


- Light Switches 
- Door sensors 
- Blinds 

- Doorbells 

- Security 

- Sirens 


Status: 
Seen: 2 
y = en 


Seen, 2012 
ly “pe canina? 


tots OM pa? T 
a Sighting 2+ Al 


(Remote L > Local r 
status 5G. 1202105 3953 
É Last Ser Lacrosse TX 
TA 


N, Spe? 1202 10 





This chapter can be the most difficult part to setup. (Depending on your needs) 


Each item has the following options: 


- Status icon that can be push to toggle on/off status (depending on the hardware) 
- Favorite push icon (to display this device on the Dashboard tab) 

- Log (Displays the log) 

- Edit (Edit device parameters, and Sub/Slave Devices) 

- Notifications (see Notification chapter) 


By Dragging/Dropping the sensor items, you can change the position of the devices in the window. 


Lights and Switches can be added by: 


- Auto Learning - Manual Setup 
- From the devices tab 
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Adding a Light/Switch by Auto Learning 


Domoticz V1.0.1 É Dashboard Y Lights/Switches 3 Temperature 7 Utility Y Devices * Hardware 


4 Manual Light/Switch Learn Light/Switch > 





By pressing the ‘Learn Light/Switch’ button you have 5 seconds to press the remote/switch/sensor. 


If this time is too short you should position yourself nearer the remote/switch/sensor by using a portable computer 
such as Tablet or Smartphone 


Once you press the button the following screen is presented: 





Add Light/Switch Device 


Name: Switch 1 


TA On/Off ”| 
As: © Main Device @ Sub/Slave Device 


Add Device Cancel 





For the switch type there are various options to choose from: 


- On/Off (a normal switch/remote button) 
- Doorbell 

- Contact (like a door sensor) 

- Blinds 

- X10 Siren device 

- Motion Sensor 


Normally you setup a new light as a ‘Main’ device, but it can also be a Sub/Slave device. 


More about Sub/Slave devices later. 
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Adding a Light/Switch Manually 


If you know the switch brand/type/address it is also possible to enter the parameters by hand. 


It is also possible to create a new ‘virtual’ device that can control a light without having to buy a remote/switch. 


Add Manual Light/Switch Device 


Hardware: 
Name: 


Type: 


Type: 


House Code: 


Unit Code: 


Test 


As: © Main Device € Sub/Slave Device 
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Sub/Slave Devices 
(One of the most difficult chapters) 


What is a Sub/Slave Device 
Most Lights can be controlled from up to 6 remotes. 


See the following two examples: 


Example 1 (Outdoor Light) 
Imagine you have an outdoor light that is controlled by a switch (*a) from inside the house. 


It is possible to buy small remote controllers (*b) for on a keychain. 


When you also want to control the outside light from this small remote, the small remote (*b) is a Sub/Slave device 
from the main switch (*a). 


Example 2 (Floor Lights) 
Imagine you have a house with two floors, each floor has its own switch (*a, first floor) and (*b, second floor). 


Downstairs next to your exit door you have a switch (*c) to turn ON / OFF ALL the lights. In this case the 
switch (*c) is a Sub/Slave device for switch (*a, first floor) and (*b, second floor) 


Consult your hardware manual on how to setup two/multiple switches for one light. 


Example 1 (Outdoor Light) Setup 
First you add the normal in-house switch (*a) like adding a normal Main light/switch as shown above: 


Add Light/Switch Device 


Name: | Outdoor Light 


Type: 
As: (9 Main Device 49 Sub/Slave Device 


Add Device Cancel 
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Next we are going to add the keychain remote (*b), but instead of choosing to set it up as Main device, we are 
selecting ‘Sub/Slave’ device: 


Add Light/Switch Device 


Name: Keychain Outdoor Light 


Type: 
As: @ Main Device © Sub/Slave Device 


DESTINA Outdoor Light i 





When selecting ‘Sub/Slave’ Device, a new option will become visible, and here we select the ‘Main’ device, in this case 
the ‘Outdoor Light’. 


Example 2 (Floor Lights) Setup 
First you add the two floor lights (*a) and (*b) like adding a normal Main light/switch as shown above: 


Add Light/Switch Device Add Light/Switch Device 


Name: | First Floor Light] Name: | Second Floor Light 


Tve: On/Off [x] TN On/Off E 


As: © Main Device € Sub/Slave Device As: © Main Device € Sub/Slave Device 


Add Device Cancel 





Next we are going to add the downstairs switch (*c) that can turn ON / OFF both floor lights. 
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Remember to select Sub/Slave Device: 


Add Light/Switch Device 


Name: | Downstairs Light 


TA On/Off dl 
As: @ Main Device © Sub/Slave Device 
DST First Floor Light 





Select the First Floor Light (*a) as the Main device. 
Now that we have added the 'Downstairs Light' we can also make this a Sub/Slave device for another Main Device. 


To at the ‘Downstairs Light’ as a Sub/Slave device for the ‘Second Floor Light’ (*b) press the ‘Edit’ button: 


Second Floor Light 


fo» Status: Off 
Last Seen: 2012-12-14 22:26:38 
Type: Lighting 1, ARC 


Name Second Floor Light 
Type On/Off 


Sub/Slave Devices: 


Name a 


No data available in table 


Showing 0 to 0 of 0 entries 





Sub/Slave Device Downstairs Light x | Add 
OO VT e ` 


From the Sub/Slave devices select the Downstairs Light (*c) and press ADD. 


Now this Sub/Slave device is also assigned to this device. 
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4 Back 


Name Second Floor Light 
Type On/Off 


Save 


Sub/Slave Devices: 


— MI 


Showing 1 to 1 of 1 entries 


Name 


Delete Clear 


Sub/Slave Device Downstairs Light 





*Note: When adding a Sub/Slave device, this will not be visible in the ‘Lights’ tab by default. You see this device in the 
‘Edit’ screen from the device you added it too. 


If you also want to control or see the Sub/Slave device, you will have to add this device again, and set it up as Main 
device. 


EnOcean 


Please note that the EnOcean hardware can only transmit with its own DevicelD. This means it will receive the real 
switches, but it cannot control these directly. 


For EnOcean it is therefore needed that you manually create switches (up to 128), and learn both the real switch And 
a Domoticz manual switch to the actual dimmer device. Set the real switch as ‘Sub/Slave’ of the Domoticz switch. 
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Notifications 


What are Notifications? 
Notifications can be used when you want to know if a switch is pressed (for example a doorbell), or when a 
temperature is below/above a certain degree, or when you power usage is above xxx Watt, etc. 


Each device has different parameters for notifications, a switch might have an On/Off state, a temperature device 
might have a temperature/humidity and a wind meter might have wind force/speed/chill... 


Setting up the Notification System 
Notifications are sent via the Prowl (iPhone) or NMA (Android) system. 


You need to create a (free) account for one/all of the above systems. Then the API key has to be specified in the 
Settings tab: 


Prowl (iPhone/iPad notification system): 


API Key: 626daEbc 13a201510c8e4692794b631e45c42af Test 
To get a free account/API key click 


NMA (Android notification system): 


API Key: 626daEbc13a201510c8e46927194b631e45c42al 


To get a free account/API key click 





If you use one of the above systems, you need to download the client on your mobile/tablet device. 


The price of the client is around 3 dollars. (On most devices, buy one time, use on all your devices) 
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Replacing Batteries 
Some devices change their unique ID when a new battery is installed. 


To replace the old sensor data to the new device act as follow: 
First, add the new device to the system, and call it for example “New UV Meter”. 


Next press the Edit button on the Old device, select replace and select the new Device. (In this case the devices called 
‘New UV Meter”. 


Replace Device 


Nieuw apparaat: 


New UV Meter v 





Next press OK. 


Now you can rename the new device back to ‘UV Meter’. 


Special Hardware Setup 


SO Pulse Meters 


At this moment Domoticz supports meters with two or five inputs that can be bought from: 
http://www.smartmeterdashboard.nl 


Once added to the hardware setup you can specify the serial baud rate for the device. 


e Two inputs = 9600 
e Five inputs = 115200 


S0 Meter USB 


Most other hardware setup related questions can be found our Wiki page http://www.domoticz.com/wiki/ 


SolarEdge 
You need to configure your solaredge so it connects to Domoticz (port 22222), Domoticz will connect to the solaredge 
website and continue to transfer your statistics 


SMASpot 


In the hardware setup you have to enter the full path the the SMASpot configuration path, for example: 


/home/pi/smaspot/bin/Release/SMAspot.cfg 
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Custom Icons 
It is possible to upload/use custom icons for On/Off switches. 


This requires a ZIP file with the following contents: 


- icons.txt 
- icon files 


You can find this option under the Settings->More menu 


icons.txt 
This is the file describing one or more icon. 


The contents is a ‘;’ delimited line with: 
Icon File Base;Title;Description 


Icon File Base 
This is the base filename for the icons in the ZIP file, for example: 


LED;My Led Ttitle;My Super Description 
The contents of the ZIP file should now be: 


- icons.txt 
- LED.png 
- LED48 On.png 
- LED48 Off.pnt 


Icon Sizes 
LED.png (16x16 pixels) 


LED48_On.png (48x48 pixels) 


LED48 Off.pnt (48x48 pixels) 


It is possible to have multiple lines in the icons.txt file 


NOTE: It is important that you use a Unique BASE filename else the upload process will return an error. 
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Browser Cache 
The web frontend is set to be cached. This will speed up the application launch time, and is perfect if you create a 
shortcut on the home screen of an iPhone/iPad/.... 


If for some reason, the page does not load correctly in Firefox / Chrome, clear this cache. 


Chrome 
From inside the Chrome browser browse to the following URL: chrome://appcache-internals/ 


You will now see all web applications that are cached. 


Find the Domoticz cache and press ‘Remove’. 


Firefox 
From the options page, go to the ‘Advanced’ page. 


At the bottom you will see all web applications that are cached. 


Select the Domoticz application, and press ‘Remove’. 


Internet Explorer 10+ 
From the options page, go to ‘General’, Under ‘Browser History’ select settings, then select the ‘Caches and 
databases’ tab. 


Select the Domoticz application, and press ‘Delete’. 
Editing HTML pages 


If you want to edit the HTML pages, you have to specify the command line option ‘-nocache’ otherwise 
changes are not being reloaded 


Receiver improvements 
Another antenna is officially not allowed because the RFXtrx is certified with the supplied antenna. 


But to increase the receiving range you can connect (for example) a 190073 Conrad 433MHz ground plane, however 
this will also increase the radiated transmit power which is illegal! (If you are not licensed to it.) 


The following adapter can be used for SMA- to BNC: 


http://www.ebay.com/itm/BNC-female-SMA-male-plug-coax-connector- 


adapter/180454327185?pt=LH DefaultDomain O&hash=item2a03ea8391 


The location of the sensor and the RFXCOM is also important if the RF signal has to pass through walls. See chapter 


2.4 in the RFXtrx User Guide http://www.rfxcom.com/documents/RFXtrx%20User%20Guide.pdf 


It is expected that RF interference is happening if sensor signals disappear for several hours. RF interference will also 
occur if sensors of the same type are configured to the same channel. 


If sensors disappear for a longer period the source of the problem can be another transmitter that is transmitting 
continuously or with short intervals. 
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If X10 MS13 sensors are in use check the battery in this sensor because when the battery becomes almost empty the 
MS13 starts transmitting a weak continuous RF signal but just enough to disturb the sensitive RFXCOM receiving. 


IPhone / IPad 

If you browse on your iPhone/iPad to the Domoticz site (for example http://192.168.0.3:8080), and add a shortcut to 
the home screen, the application will launch 90% faster, and works as a stand-alone application. It is best to add a 
shortcut for ‘internal’ and ‘external’ use. (Internal = from inside your house, External = from outside your house). For 
external usage, you need to add a firewall rule in your router. 


Sharing USB Devices over LAN 


If you would like to share USB devices via TCP/IP you can use the applications ‘Ser2Net’ or Socat. 


Participation 
We always welcome talented C++/HTML5/JQuery developers. 


If you think you want to help, please contact us at Info@Domoticz.com 


Thanks 


Thanks go out to all people that have helped during development and testing. 
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